home *** CD-ROM | disk | FTP | other *** search
/ Giga Pack / Giga Pack CD1.iso / strategy / dragon / factory.doc < prev    next >
Text File  |  1996-03-27  |  26KB  |  510 lines

  1.  
  2.                                 Tile Factory
  3.                          Version 1.2 March 27, 1996
  4.  
  5.                                 Nels Anderson
  6.                               585 Edmands Road
  7.                           Framingham, MA 01701-3088
  8.                                     U.S.A.
  9.  
  10.  
  11.  
  12. USING TILE FACTORY
  13.  
  14. The Tile Factory utility allows you to make your own sets of tiles or
  15. modify sets made by others. These tiles can be used with my solitaire
  16. games Dragons Bane: Mah Jongg II and Second Guess. The editor supports
  17. both SVGA (256 color mode) and standard VGA (16 color mode). You can
  18. recognize tile sets by the file extension .TL (for 256 color tiles) and
  19. .TLV (for 16 color tiles). Please note that these are not compatible with
  20. my earlier EGA tile games and the tiles from those games are not
  21. compatible with the VGA/SVGA games though they can be loaded, edited and
  22. saved in the new format using Tile Factory.
  23.  
  24. The utility is similar to many paint programs with which you might be
  25. familiar, though because of its specialized nature it includes less
  26. functions. Tile Factory requires a mouse and VGA or SuperVGA graphics
  27. (640x480, 256 colors).
  28.  
  29. The best thing to do is get Tile Factory running and experiment. You'll
  30. find designing good tiles is quite a challenge, but it will allow you to
  31. have your own personalized version of the game when you're done.
  32.  
  33. You might want to look at other tile sets to see some of the techniques
  34. used. Because the drawing area is so small you often have to trick the eye
  35. to get the effect you want. One thing to avoid is changing the sloping
  36. sides of the tiles. Generally this will ruin the 3D effect and simply
  37. doesn't look good when tiles are stacked up. The little triangular areas
  38. in the upper-left and lower-right corners should also be left alone as
  39. these are needed to make that portion of the tile see through when used
  40. in the game.
  41.  
  42. HOW TILES ARE STORED ON DISK
  43.  
  44. First, some basics about working with tile sets. A Mah Jongg tile set
  45. includes 42 different tiles. Eight of them are in the "wild card" suits
  46. (normally the flowers and seasons suits) where any tile in the suit
  47. matches any other. The other 34 tiles use the standard matching rule where
  48. there are four of each tile on the board and the tiles must be matched
  49. exactly to be removed. You'll want to keep the matching rules in mind when
  50. designing tiles for compatibility with Dragons Bane: Mah Jongg II.
  51.  
  52. Second Guess only needs 36 tiles. Tiles 1 through 34 are used plus tiles
  53. 35 and 39.
  54.  
  55. All 42 tiles are stored in a single disk file. You'll need to know how the
  56. tiles are numbered so that you store your new tiles in the proper place.
  57. For reference, the standard Mah Jongg tile set is numbered as follows:
  58.  
  59.             Tiles 1 - 9:  suit of dots
  60.                 Tile 10:  white dragon
  61.           Tiles 11 - 19:  suit of bamboo
  62.                 Tile 20:  green dragon
  63.           Tiles 21 - 29:  suit of characters
  64.                 Tile 30:  red dragon
  65.           Tiles 31 - 34:  suit of winds
  66.           Tiles 35 - 38:  suit of seasons
  67.           Tiles 39 - 42:  suit of flowers
  68.  
  69. GETTING STARTED
  70.  
  71. Start up "FACTORY.EXE" by typing "factory" on the command line. You can
  72. include the name of a tile set file on the command line and that tile set
  73. will be immediately loaded once Tile Factory starts up. Note the drawing
  74. area on the left and the tile set display on the right. If you did not
  75. include a tile set name on the command line the tile set displayed will be
  76. blank, but as soon as you read in a tile set it will be shown.
  77.  
  78. The editor will automatically start up in the best available graphics mode.
  79. If Tile Factory can run in 256 color mode it will, otherwise it will run
  80. in standard 16 color VGA mode. If you wish you can force the editor to run
  81. in 16 color mode by using a command line option. To force 16 color VGA
  82. start up the editor with this command:
  83.  
  84. FACTORY -16
  85.  
  86. Please note that the space and dash are required.
  87.  
  88. Some people have a problem with the mouse sensitivity and you can also
  89. use a command line option to adjust this. Use this command:
  90.  
  91. FACTORY -M#
  92.  
  93. where the # is replaced with a number between 1 and 6. Lower numbers
  94. will make the mouse move faster; the default value is 4. You can also
  95. change the mouse sensitivity at any time while using Tile Factory by
  96. hitting the F9 key.
  97.  
  98. Once the editor is running, along the top of the screen are a series of
  99. menus you can select. If you're using a mouse you just need to point to
  100. the word you want and click. If using the keyboard you can use the
  101. functions keys (each menu is numbered sequentially so Help is F1, Info is
  102. F2, etc.). You can also select menus by holding down the Alt key while
  103. also hitting the first letter of the menu name; for example, you'd hit
  104. Alt-F to open the File menu.
  105.  
  106. DRAWING
  107.  
  108. Normal drawing (single dot at a time) can be done with the keyboard or
  109. mouse. Using the mouse, select the desired color by pointing at the color
  110. chart and clicking. Then to draw just point at the drawing area and click
  111. on each spot where you want to draw.
  112.  
  113. Because it's common to switch back and forth between two colors, Tile
  114. Factory remembers the last color you've selected as well as the current
  115. one. Use the right mouse button at any time to toggle back and forth
  116. between the current and previous drawing color.
  117.  
  118. There are a few basic drawing shapes available in addition to the simple
  119. dot. Under the drawing area is a set of push buttons where you can select
  120. dots, line, circle, rectangle, filled circle or box. Click on the desired
  121. button and you'll see it push in to confirm proper selection.
  122.  
  123. When using the line or rectangles, move the mouse cursor to one end
  124. (corner) and hold down the mouse button. Then move to the other end
  125. (corner) and release the button. When using the circles you start in the
  126. center and pull away until the circle is the desired size. You can pull in
  127. any direction since the circle is symmetrical.
  128.  
  129. The seventh drawing tool is a special one. It allows you to outline an
  130. area and then change all pixels within that area that are a specific color
  131. into a different color. Select this tool and then outline a rectangle just
  132. as you would with the rectangle drawing tool. When the area you want is
  133. outlined, release the mouse button.  You'll be prompted to select the
  134. color you want to change; point anywhere you want on the screen and click
  135. when pointing to the desired color. Then you'll be prompted for the color
  136. you want to change to; again you can point anywhere on the screen and
  137. click. Now the selected color will change.
  138.  
  139. The eighth function is fill. Using this function you can fill in an area
  140. of any shape with the currently selected color. When you select fill the
  141. cursor will change to the word "FILL" with a little target to the upper
  142. left. Position the target in the area you want filled and click to fill.
  143. Using the keyboard you can fill by moving the keyboard cursor within the
  144. area to be filled and hitting the Z key.
  145.  
  146. Fill can also use a range of colors instead of just a single color.
  147. Instead of left clicking, click the center button (or both buttons if you
  148. have a two button mouse). You'll be prompted for a range of colors similar
  149. to the shade function and the area will be filled with randomly selected
  150. colors from the range you chose.
  151.  
  152. The ninth function is text entry. Because of the small size of the tiles
  153. only two simple fonts are used. The smaller font is 5 pixels high and the
  154. larger one is 7 pixels high. Several different widths are available and
  155. Tile Factory will try to use the widest characters possible given the space
  156. available. Depending on whether you have border set on or off (from the
  157. Text menu) the letters may go right to the edge of the tile face or a one
  158. pixel border will be enforced.
  159.  
  160. To enter text, position the mouse to the upper left corner of where the
  161. text should start (if using the keyboard, use the arrow keys to position
  162. the keyboard cursor and then hit the L key). You'll then be prompted to
  163. enter the text you want. Lower case letters are not available but capital
  164. letters and most other characters can be used.  If the text you enter is
  165. too much to fit in the available space you'll be told how many pixels too
  166. wide it is and you can then adjust accordingly.
  167.  
  168. When within the drawing area, the mouse cursor snaps to the center of each
  169. pixel when moving around or drawing dots, lines or rectangles. If you
  170. prefer that the cursor move smoothly you can turn off the snap function by
  171. using Snap Cursor on/off under the Options menu. For most drawing you'll
  172. probably find the snap cursor useful as you'll be able to more clearly
  173. tell what pixel is being pointed to.
  174.  
  175. Some people find using the keyboard useful for some drawing situations. To
  176. draw with the keyboard move the cursor around with the arrow keys and hit
  177. space when you want to draw a dot. If you hold down the space bar a line
  178. of dots will be drawn in the direction of the last arrow key used.
  179.  
  180. When drawing the position of the mouse cursor is shown just below the
  181. color selection area. If you wish to see the position of the keyboard
  182. cursor instead, just move the mouse cursor outside the drawing area and
  183. move the keyboard cursor with the arrow keys.
  184.  
  185. COLORS IN 256 COLOR SVGA MODE
  186.  
  187. A color bar is shown in the middle of the screen. To select a color just
  188. move the mouse over it and click. In SVGA mode only 32 colors are shown at
  189. a time out of the 256 colors available. The remaining colors can be shown
  190. by clicking on the arrows at the top and bottom of the color bar.
  191.  
  192. When you select a color its number is displayed at the bottom of the color
  193. bar. Because some colors are so similar it's often easier to reference the
  194. number than to try to recognize a color by appearance.
  195.  
  196. In addition, the color and its composition is shown below the drawing.
  197. Each color is made up of a combination of red, green and blue and its
  198. makeup is shown here. Each color can have brightness values of 0 through
  199. 63. By clicking on the arrows over and under the individual colors you can
  200. change their values. Remember, though, that when you do this you change
  201. every place that color is used in your tile set. You will see the change
  202. take place immediately. Any changes you make to the color palette will be
  203. saved with the tile set the next time you save a tile.
  204.  
  205. Colors numbered 0 through 23 cannot be changed as they are used for game
  206. menus, etc. Color 16 is special; it is used for the "see through" corners
  207. of the tiles. You should avoid using colors 16 through 23.
  208.  
  209. When running 256 color mode you can load 16 color tile sets (files ending
  210. in .TLV). They will load correctly but you will not be able to save them
  211. in 16 color mode. You can, however, convert the entire set to 256 colors
  212. and save it as a 256 color tile set (a file ending in .TL).
  213.  
  214. COLORS IN 16 COLOR VGA MODE
  215.  
  216. As with 256 color mode a color bar is shown in the center of the screen.
  217. To select a drawing color just point to it and click the mouse. All 16
  218. available colors are shown at all times.
  219.  
  220. Unlike SVGA mode you cannot change the available colors. You also do not
  221. have to worry about the see through color or other special colors. You
  222. should, however, be sure to leave the white triangles in the corners
  223. unchanged as these will become see through when the tiles are used in
  224. the game.
  225.  
  226. When running 16 color mode you can load 256 color tile sets (files ending
  227. in .TL) and they will automatically be converted to 16 colors. How well
  228. the conversion works varies but you will at least get a usable tile set
  229. that you can further touch up and save as a 16 color file.
  230.  
  231. MENUS
  232.  
  233. Many functions have keyboard shortcuts that are shown in parentheses after
  234. the name of the function. You can use these keys to access functions
  235. directly without going through the menus. A list of all keyboard shortcuts
  236. is at the end of this document.
  237.  
  238. If using a mouse you just point to the function you want and click. If
  239. using the keyboard you can select menus using the function keys or the Alt
  240. key plus the first letter of the menu name. Within the menus you can
  241. select functions by number or by using the arrow keys to move to the
  242. function you want and the Enter key to select it.
  243.  
  244. Most of the functions available from the menu are pretty self-explanatory,
  245. but let's cover each menu and function in detail.
  246.  
  247. HELP
  248.  
  249. Under the help function is an abbreviated set of instructions for using
  250. Tile Factory. To move from one help screen to another click on the Next
  251. or Prev (previous) box. To quit help click on the Quit box. You can also
  252. use the letters shown in red for next, quit or previous.
  253.  
  254. FILE MENU
  255.  
  256. This is the menu used for disk access. The first choice allows you to
  257. clear any current drawing and start a new tile. You'll be prompted to make
  258. sure you mean to do this.
  259.  
  260. Save Tile allows you to save your work into a tile set file. You'll first
  261. be prompted for the name of the file that your tile should become part of.
  262. If you are creating a new tile set you must type in the file name
  263. otherwise you can just click on the file name in the list. If the file you
  264. choose is different from the last one you read in, the new file will be
  265. read in and displayed on the right side of the screen; if creating a brand
  266. new set the right side of the screen will be blank. Finally, you must
  267. choose what position your tile will take. If you're editing an existing
  268. tile and just want to put it back in the same position you just need to
  269. click on OK. Otherwise you can either enter the new position number from
  270. the keyboard or you can point and click on the tile on the right side of
  271. the screen you wish to replace.
  272.  
  273. Read Tile Set allows you to read tiles from the disk. The entire tile set
  274. is always loaded and displayed on the right side of the screen. If the set
  275. does not contain all 42 tiles blanks will be shown at some positions.
  276.  
  277. The Load Tile function is only needed if you don't have a mouse. It allows
  278. you to transfer a single tile from the tile set shown on the right side of
  279. the screen into the editor. When prompted enter either the number of the
  280. tile you want to edit or hit the Esc key to abort.
  281.  
  282. Import .PCX Picture gives you the ability to load tile faces from PCX
  283. drawings, such as you might create with a full-featured paint program or
  284. with a scanner. Note that this feature may not work with all .PCX files.
  285. It may be helpful to convert images to 640x480, 256 color images with an
  286. external utility before attempting to load them into Tile Factory.
  287.  
  288. If running in SVGA mode Tile Factory gives you three options on how the
  289. color palette is used when importing a .PCX picture. If adding the image
  290. to an existing tile set you should choose "Current palette" as this will
  291. prevent your existing tiles from changing colors. This choice may cause
  292. the picture to not look right, though, as its colors will have to be
  293. changed to match those available in the current palette.
  294.  
  295. If starting a new tile set you should choose "Palette from picture". This
  296. will load the picture in its original colors and change the current color
  297. palette to match.
  298.  
  299. The third choice is a combination of the first two. Choosing "Combined
  300. palette" prevents any of your current tiles from changing colors while
  301. using as many of the original colors as possible from the imported
  302. picture. This will result in changes to your current palette, but only to
  303. colors that had not been used in any tiles.
  304.  
  305. When you select import .PCX picture, the normal file selection box will
  306. pop up and you should select the PCX file you want. The picture will load
  307. and a square cursor will appear. Use the cursor to surround the portion of
  308. the picture you want (the square is exactly the size of a tile face) and
  309. click. You'll be switched back to the editing screen with the PCX image
  310. now on the tile face. If you're using the keyboard you can use the arrow
  311. keys to move the cursor around and the Enter key to select. Hit Esc to
  312. abort.
  313.  
  314. When you're done with your tile set, use the add name function. The name
  315. you enter will be displayed in the Info screen when playing Second Guess
  316. and at the top of the screen when viewing the complete tile set. The name
  317. for the currently loaded tile set is also shown at the right bottom of the
  318. Tile Factory screen.
  319.  
  320. At some point you may wish to rearrange the order of the tiles in the set.
  321. You can use the swap two tiles function to swap the positions of any two
  322. tiles in the currently displayed set. When prompted, select each of the
  323. tiles that you want swapped either by entering the tile number or by using
  324. the mouse to point and click. If you change your mind hit the Esc key or
  325. select "No" when asked to confirm.
  326.  
  327. Tile sets are normal files that can be copied, moved, deleted, etc. like
  328. any other file. You can, if you wish, also delete tile sets that are no
  329. longer needed from the file menu using the Delete Tile Set function.
  330.  
  331. If using 256 color mode you can load and save the current color palette
  332. for use in other tile sets using functions from the File menu.
  333.  
  334. EDIT MENU
  335.  
  336. This menu allows you to do special editing functions on the current tile.
  337. These functions are described below.
  338.  
  339. The flip functions let you reverse the image left/right or top/bottom.
  340. Hitting the same function a second time will flip the image back the way
  341. it originally was.
  342.  
  343. The shift functions move the image in the specified direction by one
  344. pixel. This is handy if, for example, you want to center an image.
  345.  
  346. Sometimes when drawing you'll want to match a color already in the picture.
  347. The Get Color function lets you select your current drawing color from
  348. within the drawing rather than from within the color bar.  When you select
  349. this function the cursor will change to a cross plus the word "get". Move
  350. the cross over the color you want and click to select the new active color.
  351.  
  352. The Copy function lets you outline and copy one part of your picture to
  353. another part. After selecting Copy move the cursor to the upper left
  354. corner of the area you want to copy. Then hold down the left mouse button
  355. and move to the lower right corner. When you release the button the area
  356. inside the rectangle will be saved. You can then use the Paste function to
  357. copy the saved image back into the tile or into another tile. You can use
  358. Paste as many times as you wish.
  359.  
  360. The Shade function lets you take advantage of the SVGA color palette.
  361. After selecting Shade, position the cursor at the upper left corner of the
  362. area you want to shade then hold down the left mouse button while moving
  363. to the lower right corner. You'll then select which color within this area
  364. you want changed. Finally, you'll select the range of colors you wish the
  365. area to be changed to. For example, if you select first color 24 and then
  366. color 28 the area will be filled from the top with color 24 gradually
  367. changing to color 28 at the bottom.
  368.  
  369. Note that the order you select the color range effects the way the shading
  370. is done. Shading always starts at the top of the selected rectangle with
  371. the first selected color. You can thus control whether the shading will go
  372. from dark to light or light to dark.
  373.  
  374. If you don't want shading but just randomly selected colors within a
  375. specific range use fill instead.
  376.  
  377. Undo is also available from this menu. Using this will restore the tile as
  378. it was before the most recent change. The image that will be restored is
  379. shown along the left side of the screen directly below the current image.
  380. You can also undo by clicking directly on the previous image, or on any
  381. other image that is below it. Up to five previous images are kept along
  382. the left side of the screen.
  383.  
  384. OPTIONS MENU
  385.  
  386. This menu allows you to select options that affect how other functions
  387. work. Each option can be toggled on or off. If an option is currently on a
  388. check mark will be shown to the right of the option name.
  389.  
  390. When Tile Factory starts up it is set with snap cursor on. In this mode
  391. the mouse cursor jumps to the center of each pixel when in the drawing
  392. area, which ensures that you know exactly what pixel you're drawing. If
  393. you prefer you can turn this mode off and the cursor will then move
  394. smoothly.
  395.  
  396. When drawing with the dot tool (freehand drawing) you can have your
  397. drawing mirrored left to right, top to bottom, or both. Toggle the
  398. appropriate mirror settings on and off to fit your needs.
  399.  
  400. TEXT MENU
  401.  
  402. The first three options let you choose whether text you enter will be left
  403. justified, right justified or centered. A check mark will indicate which
  404. choice is currently selected.
  405.  
  406. Two fonts are available, the smaller one being 5x5 pixels and the larger
  407. 5x7 pixels. Choose the font you want from this menu. The currently
  408. selected font will be indicated with a check mark.
  409.  
  410. When entering text using the text tool you have a choice on how close to
  411. the edge the text will be entered. Text usually looks best if there is a
  412. border around it at the edge of the tile face. However, if you have a long
  413. word that you wish to display you might want to disable this border to
  414. make the text fit. Try entering text first with the border enabled, but if
  415. you only need one or two more pixels to make it fit you can turn the
  416. border off and try again.
  417.  
  418. SPECIAL MENU
  419.  
  420. This menu accesses special functions that will not be used often.
  421.  
  422. There are many tile sets available for my older tile solitaire games. The
  423. tiles were drawn in a 640x350 pixel, 16 color mode. The Special menu
  424. allows you to load and convert these tiles to VGA or SVGA format.
  425.  
  426. The Load EGA Tiles function simply loads an old style tile set. These
  427. tiles are 40x40 pixels whereas Tile Factory tiles are 40x55, so an area at
  428. the top of the tile is filled in. Tile Factory attempts to fill with a
  429. color that will match the rest of the tile.
  430.  
  431. If simply loading the tile sets does not produce a pleasing result two
  432. options are available to modify tiles. The first simply centers the tile
  433. face image in the new, larger tile. In many cases this is all that's
  434. needed to use an older tile set.
  435.  
  436. However, the aspect ratio of old and new tile sets is quite different so
  437. many old tile sets look "squished" when loaded into Tile Factory. An
  438. option is available to scale old tiles to the new format. This will
  439. correct the aspect ratio, but quite often you'll need to do additional
  440. editing to make the tiles look good.
  441.  
  442. Note that the center and scale functions work on the entire tile set as
  443. currently displayed on the right side of the screen.
  444.  
  445. With so many colors available it can be hard to keep track of which ones
  446. you've actually used. The Color Usage Graph function displays a chart of
  447. all colors with line height indicating frequency of use for each color.
  448. You can move the cursor into the chart to get exact values for colors of
  449. interest. The color number, what the color looks like, and how often it is
  450. used in your tile set are then shown. You can also use the chart to select
  451. a new color for drawing. Point to the color you want and click. The cursor
  452. will move to the Done button; click again to close the window and the new
  453. color will be selected.
  454.  
  455. Share Your Creations!
  456.  
  457. If you develop any tile sets you'd like to share please upload them to the
  458. support BBS (Xevious: 508-788-6951) or mail them to the author on a
  459. diskette. I'd suggest that you include a text file describing your tile
  460. set. If you do include a text file give it the same basic file name as the
  461. tile set file; for example, the tile set MYTILES.TL would have a text file
  462. MYTILES.TXT. You should also include your name in both the tile set itself
  463. and in the text file. I'm looking forward to seeing what you come up with!
  464.  
  465. KEYBOARD SHORTCUTS
  466.  
  467. Many Tile Factory functions can be accessed from the keyboard. Below is the
  468. complete list of keys and their function.
  469.  
  470.                    Key  Function
  471.           ------------  ------------------------------------
  472.            F1 or Alt-H  Help
  473.            F2 or Alt-I  Info
  474.            F3 or Alt-F  File Menu
  475.            F4 or Alt-E  Edit Menu
  476.            F5 or Alt-O  Options Menu
  477.            F6 or Alt-T  Text Menu
  478.            F7 or Alt-S  Special Menu
  479.                     F9  Increase mouse sensitivity
  480.           F10 or Alt-Q  Quit (exit Tile Factory)
  481.  
  482.                      X  New (clear tile)
  483.                      S  Save Tile
  484.                      R  Read Tile Set
  485.                  Alt-L  Load Tile Into Editor
  486.                      P  Import .PCX Picture
  487.                      N  Add Name To File
  488.                  Alt-D  Delete Tile Set
  489.                      Q  Quit (exit Tile Factory)
  490.  
  491.                      <  Flip left to right
  492.                      >  Flip top to bottom
  493.                      -  Shift Right
  494.                      +  Shift Left
  495.                      ^  Shift Up
  496.                      |  Shift Down
  497.                      G  Get Color
  498.                      U  Undo
  499.                      L  Use the letter function (enter text)
  500.                      Z  Use the fill function
  501.  
  502.                      #  Snap Cursor on/off
  503.                      M  Mirroring left/right on/off
  504.                  Alt-M  Mirroring top/bottom on/off
  505.                      T  Text Border on/off
  506.  
  507.                                   - - - - -
  508.  
  509.    Tile Factory is copyright 1996 by Nels Anderson.  All rights reserved.
  510.